CallEventHandler

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallEventHandler
The CallEventHandler method processes the specified Apple event object for the part.
void CallEventHandler (in ODPart thePart, 
                       in ODAppleEvent theODAppleEvent,
                       in ODAppleEvent reply);
thePart
A reference to the part associated with this semantic interface object.
theODAppleEvent
A reference to the Apple event object to be processed.
reply
A reference to a reply Apple event object returned by the message interface object's Send method.

DISCUSSION
This method processes the event, resolving any object specifiers along the way, and returns an appropriate reply in the provided Apple event object. This method should be capable of handling all the Apple event objects your part supports, responding to all events your part supports, and generating an appropriate exception if the specified Apple event object is not supported.
If any of the parameters specified in the theODAppleEvent parameter are object specifiers, your method should resolve them using the name resolver's Resolve method.

EXCEPTIONS
The Apple Event Manager may throw an exception if this method is unable to handle the specified Apple event object.
This method may throw platform-specific exceptions.

SEE ALSO
The ODNameResolver::Resolve method (page 426).
The ODMessageInterface::Send method (page 416).
The ODAppleEvent class (page 41).
"Writing Semantic-Event Handlers" on page 424 in OpenDoc Programmer's Guide.